Chuyển tới nội dung chính

Gửi yêu cầu HEAD (http.head)

Khai báo​

mã trạng thái HTTP, văn bản JSON của header phản hồi = http.head(URL [, thời gian chờ tính bằng giây, header yêu cầu, không escape URL ])

Khai báo (đối số có tên)​

Hỗ trợ từ phiên bản 20250625; các tùy chọn tiến trình được hỗ trợ từ phiên bản 20260402

mã trạng thái HTTP, văn bản JSON của header phản hồi = http.head{
url = URL;
timeout = thời gian chờ tính bằng giây;
headers = header yêu cầu;
params = tham số query;
progress = hàm gọi lại tiến độ;
progress_interval_ms = khoảng thời gian giữa các lần gọi lại tiến độ tính bằng mili giây;
}

Tham số​

  • URL
    Kiểu chuỗi. URL yêu cầu. Hàm mặc định escape URL; xem không escape URL nếu không muốn xử lý này.
  • thời gian chờ tính bằng giây
    Kiểu số, không bắt buộc. Thời gian chờ tính bằng giây. Mặc định: 10.
  • header yêu cầu
    Kiểu bảng, không bắt buộc. Header yêu cầu có dạng { field1 = value1, ... }. Mặc định: {}.
  • tham số query
    Kiểu bảng, không bắt buộc. Tham số chuỗi truy vấn có dạng { field1 = value1, ... }. Mặc định: {}.
  • hàm gọi lại tiến độ
    Kiểu hàm, không bắt buộc. Hỗ trợ từ phiên bản 20260402. Được gọi khi tiến trình yêu cầu thay đổi; đối số đầu tiên là thông tin tiến trình hiện tại.
  • khoảng thời gian giữa các lần gọi lại tiến độ tính bằng mili giây
    Kiểu số nguyên, không bắt buộc. Hỗ trợ từ phiên bản 20260402. Khoảng thời gian giữa các lần gọi lại tiến độ, tính bằng mili giây.
  • không escape URL
    Kiểu boolean, không bắt buộc. true = không escape URL. Mặc định: false.
    Để tự escape, hãy xem mô-đun lcurl, easy:escape và easy:unescape.

Giá trị trả về​

  • mã trạng thái HTTP
    Kiểu số nguyên. Mã trạng thái HTTP; trả về -1 khi hết thời gian chờ.
  • văn bản JSON của header phản hồi
    Kiểu chuỗi hoặc nil. Header phản hồi ở định dạng JSON; trả về nil khi hết thời gian chờ.

Mô tả​

Dùng phương thức HEAD của HTTP/1.1 để lấy header phản hồi.
HEAD thường trả về cùng header với GET nhưng không có nội dung phản hồi.
Hàm này có thể nhường quyền thực thi; các luồng khác có thể được chạy trước khi hàm trả về.

Bảng info được truyền cho hàm gọi lại tiến độ có cấu trúc như sau:

{
count_of_bytes_sent = bytes_sent;
count_of_bytes_expected_to_send = bytes_expected_to_send;
count_of_bytes_received = bytes_received;
count_of_bytes_expected_to_receive = bytes_expected_to_receive;
}

Ví dụ​

local c, h = http.head("https://www.xxtouch.app/测试文本.txt")
if c==200 then
sys.alert(h)
end

Lưu ý: Ví dụ trên sử dụng hàm ngoài chương này sys.alert.